Add doc for exif options.
authoroliskoli <oliskoli>
Sun, 21 Sep 2008 15:51:55 +0000 (15:51 +0000)
committeroliskoli <oliskoli>
Sun, 21 Sep 2008 15:51:55 +0000 (15:51 +0000)
xmldoc/formats/exif.xml
xmldoc/formats/options/exif-frame.xml [new file with mode: 0644]
xmldoc/formats/options/exif-name.xml [new file with mode: 0644]
xmldoc/formats/options/exif-overwrite.xml [new file with mode: 0644]

index 4d695863874688d645fdc1a978b74bd8b13ec01f..d8d1bc48b3ff2ff349d93f28c9ae0409a47aeb8a 100644 (file)
@@ -1,6 +1,6 @@
 <para>
-  This format reads GPS information embedded in 
-   <ulink url="http://www.exif.org">EXIF </ulink>, 
+  This format reads and writes GPS information embedded in 
+   <ulink url="http://www.exif.org">EXIF</ulink>, 
    the Exchangeable Image Format, data.  EXIF is a standardized method
   of encoding data in pictures such as JPEG, TIFF, and WAV and is frequently
   used by mobile phones with cameras, cameras with built-in GPS.
diff --git a/xmldoc/formats/options/exif-frame.xml b/xmldoc/formats/options/exif-frame.xml
new file mode 100644 (file)
index 0000000..c0014ce
--- /dev/null
@@ -0,0 +1,16 @@
+<para>
+   Frame means the maximum time difference that we accept between the EXIF time information
+   of a picture and the timestamp of a track-, route- and waypoint used for tagging. 
+   Without this option the maximum time frame is 10 seconds.
+</para>
+<para>
+  <userinput>gpsbabel -i gpx -f holiday.gpx -o exif,frame=60 -F IMG0784.JPG</userinput>
+</para>
+<para>
+   If the camera time wasn't adjusted, you should move the track(s) by the this difference.
+   I.e. if the camera time is five minutes behind your time, the track(s) should be shifted
+   five minutes back.
+</para>
+<para>
+  <userinput>gpsbabel -i gpx -f holiday.gpx -x track,move=-5m -o exif,frame=60 -F IMG0784.JPG</userinput>
+</para>
diff --git a/xmldoc/formats/options/exif-name.xml b/xmldoc/formats/options/exif-name.xml
new file mode 100644 (file)
index 0000000..0ad934e
--- /dev/null
@@ -0,0 +1,9 @@
+<para>
+   When you specify a name with this option we're looking for a waypoint
+   with this name. And, if found, the GPS information of this point is used
+   for tagging the image file.
+</para>
+<para>
+  <userinput>gpsbabel -i gpx -f holiday.gpx -o exif,name="On the beach" -F IMG0786.JPG</userinput>
+</para>
+
diff --git a/xmldoc/formats/options/exif-overwrite.xml b/xmldoc/formats/options/exif-overwrite.xml
new file mode 100644 (file)
index 0000000..1553208
--- /dev/null
@@ -0,0 +1,6 @@
+<para>
+   In the default case GPSBabel reads the output file (the file that should be
+   tagged with GPS information) and then creates a new file with an additional
+   .JPG extension. With this option in a final step the original file will be
+   deleted and the new file renamed as the original filename.
+</para>